Migrating from Tronweb v5

To better support its use in TypeScript project, we have rewritten the entire library in TypeScript. And to make TronWeb API more secure and more consistent, there are some breaking changes.

This is an experimental beta version. Please check out 6.x API documentation for detailed APIs. You can open an issue here if you have questions or feedback.

The breaking changes are listed below.

Change Default exports to Named exports

The default export of the project is no longer the TronWeb class. You can use import { TronWeb } from 'tronweb'; instead. And other constructors are also no longer mounted on the TronWeb class. You have to use the same way to import them. For example if you want to use TronWeb.utils, you should import { utils as TronWebUtils } from 'tronweb'; and then use TronWebUtils; Example:

import { TronWeb, utils as TronWebUtils, Trx, TransactionBuilder, Contract, Event, Plugin } from 'tronweb';

Some methods are changed

TronWeb.createRandom

Change TronWeb.createRandom(options) to TronWeb.createRandom(password, path, wordlist).

TronWeb.fromMnemonic

Change TronWeb.fromMnemonic(mnemonic, path, wordlist) to TronWeb.fromMnemonic(mnemonic, path, password, wordlist).

utils.abi.decodeParams

The parameters are as follows: utils.abi.decodeParams(names: string[], types: string[], output: string, ignoreMethodHash = false) You must pass names argument. If there is no name, pass an empty array.

utils.code.hexStr2byteArray

utils.code.hexStr2byteArray will not verify whether the argument is a string.

Strict check for position and type of parameters

In the previous version, most methods support variable parameter length. For example, the following codes are both valid:

// Normally the third parameter is 'fromAddress', and the forth is options.
await tronWeb.transactionBuilder.sendTrx('toAddress', 10, 'fromAddress', { permissionId: 1 });

// If the third parameter is object, it will be treated as options and fromAddress will be tronWeb.defaultAddress.
await tronWeb.transactionBuilder.sendTrx('toAddress', 10, { permissionId: 1 });

In v6.x, we do not support ignoring some of the arguments between required arguments and object arguments such as options with permissioinId.

Throw Error instance instead of string when error occurs

In the previous version, most methods support a callback parameter to get an asynchronous result. And if no callback is passed, the method returns a promise with injectpromise. If you catch an error, you will receive a string message:

try {
  await tronWebV5.transactionBuilder.clearABI('3333');
} catch (e) {
  console.log(typeof e); // will print 'string'
}

In v6.x, we removed this feature and all mothods only return a promise. When an method throws error, you will receive an Error instance:

try {
  await tronWeb.transactionBuilder.clearABI('3333');
} catch (e) {
  console.log(typeof e); // will print 'object'
  console.log(e.message);
}

Method will throw error with Invalid privateKey

In the previous version, TronWeb.trx#multiSign() reports that the key has no permission to sign if you pass an invalid privateKey.

In v6.x, the method will throw an error if the privateKey is invalid. And wherever you use an invalid privateKey, an error is also output.

TronWeb#sidechain is removed.

Sidechain has been removed from TronWeb. If you still want to use it, use SunWeb instead.

Events service has changed.

Event#watch() is removed.

contract.someEvent().watch() is no longer supported.

Events backend services have changed.

Since a new backend service is provided for querying contract events, there are some changes in the returned data structure compared to the previous version.

The standard format of the return value of the event query API is shown as follows:

{
    "success":true,
    "data": [
      {
          "block_number": 42054864,
          "block_timestamp": 1700704884000,
          "caller_contract_address": "TPYwAC9Y4uUcT2QH3WPPjqxzJSJWymMoMS",
          "contract_address": "TPYwAC9Y4uUcT2QH3WPPjqxzJSJWymMoMS","event_index": 1,
          "event_name": "Transfer",
          "result": {
             "0": "0x65fa68800fff5a10346d1a3aa1fb2ce92f2e2971",
             "1": "0xbbd6d9c36cf31f73b01ad2415b12d9d2bda7fb08",
             "2": "27000000","from":"0x65fa68800fff5a10346d1a3aa1fb2ce92f2e2971",
             "to": "0xbbd6d9c36cf31f73b01ad2415b12d9d2bda7fb08","value": "27000000"
          },
          "result_type": {
            "from":"address",
            "to":"address",
            "value":"uint256"
          },
          "event": "Transfer(address indexed from, address indexed to, uint256 value)",
          "transaction_id": "9c9e4776de1ee889aad48be360262e3dd6d1a1e3d4e0d7c72dc50075260846df"
        }
    ],
    "meta": {
        "at":1700720666204,
        "page_size": 1
    }
}

New API

1. getEventsByBlockNumber Query events by block number.

2. getEventsOfLatestBlock Query events of the latest block.